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I. INTRODUCTION^ 

This docuwent describos t^• LOGO tytttm iinprMwntid for th« POP U/45 at . 
the tl.I.T. Artificial Intt 1 1 igtnc* Laboratory. Tht "ayttM" includes not 
only the LOGO evaluator; but «lfO « dtdic«t«d tiiiit--th«rfng tusttfti uhich 
services about a dozen uiers. There are alec various aptcial devices such 

as ro^ot turtles, tone generatore* and CRT ditpfayi. 

/ 

Ue feel obliged to begin uith soimi dteclaimere. This nanual is 
intended only as a language description and not as a primer. Ue hope it 
ui 1 1 be useful as a reference for users of our system and as a source of 
comparison for users of other LOGO sgsttms^ Sicond)y«\ue believe thab the 
syntactic details of a computer language are of insigni ft cimt important 
compared to considerations of hou the language is usedt Anyone Mho reads 
this paper to find out "uhat LOGO is like** should ixit Mglect the papmrt of 
Pdpert and Solomon. FinaHy; the LOGO language is part of an ongoing 
research project. It is to be fully expected that the language 
specifications will change Mith our expert enca* » 

t4hile there have been numerous contributors to the development of 
the LOGO language* those specifically concerned uith the POP 11 
implementation are: 

Ron Lebel, time'-sharing system; Made Uilliamst LOGO pvaluatori Joe 
Cohen/ time-sharing input/output; Nat Goodman and Hal AbeJson, display aind 
music box; Ron Label and Roger Haie« filing system. As part of the PDPll 
programming project ue have developed a POP U debugging program uhich is- 
simitar but more ^Msrfut than.OEC*s GOT program. This was done by Radia 
Per Iman. Our display controller uas dsfigned and but It by Tom Knight. 
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There is also an essentially conpat^ble LOGO eValMtor uhich h«| been » 
inpieiiented in (O-I.T.'s veriion of) LISP'bg'ira Goldstein and Henry 
Lleberman. Ue must also cite the contributlone of'Richard Greenblatt on 
matters of aystew design and, of cckjrse, Seyiwur Papert aftd. Cynthia Solomon 
iOn language specification. . - 

* Hal Abeleon 

' ' . Nat Goodman 
Lee Rudolph 

, T 

t 
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2. BASICS 

This stction introducfi •oiiitljttlc LOGO vocabulary. LOGO , 
stat«M«nts art'tupad in at tha conaola. You typa a Una instruct Ion* 
apd th* coMputer axecutar it (or tuiMt an arror Mtsaga). Tha computar 
indlcatea that it it raady for an. instruction by ty(/ing a quastion marki' 
Your lina of instructions uiii not ba aMacutad until uou and tha I Ina by 
tgplng a carriaga raturn. 

The basic "built-in* uords that tha coaputar undaratanda ara cada* 
"LOGO priwitives. Thasa ara dascribad In this Manual. Tha Most iMportant 
priMitive is TO, which ailous you to taach tha coaputar nan uorda. Thaaa 
privtta words that you taach tha coapu.tar ara cailad procaduraa . 

PriMitivas and proeaduras of tan taka ona or Mora Itouta . For 
exawple. PRINT is a iiriMitiva Mh«ch takas ona Input and printa It on tha 
console. ' . 

•> 

PRINT is an aHaapla of a coMjand. A coaMand la an iMparativa. It 
tella the coaputar to do soaething. 

Other priMitives May output. Thay provide a value uhlch can ba 
used as an input for another LOGO word. SUM, for axaapla, takes two 
nuaeric inputs and outputs their eua. Procedures uh I ch output ara cailad 
operations . * 

All coaplete LOGO stataMents are .laperativai, ab that an oparation* 

cannot stand by itsalf.^r If you typet 

sun 17 26 

Logo uIII respond with the error Messagei 

YOU DON'T SAY UHAT TO 00 WITH 43. 
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In contrast: ' » 

PRINT sun 17 26 

it • coM^iete stateiwnt. Tha computw* tii 1 1 print 43. 

If you MkB a typinfl Mistake you can prass tha "dalata* or "rubout" 

key. This causes LOGO to iynora ^ha prsai^ious charactar. It indicataa thia 

by retyping the ignored character with si ashaa around It. Praaeing rwpout 

again Hill cause LOGO to ignore tha charactar bafora that, and so on. 

Another feature Is the 'panic button" ctl-C (control G). Typing ctl-G 

in the middle of a coiniand line causes the entire line to be ignored. 

Typing ctl-G uhiie LOGO it executing a coaMnd causae it to stop and 

returns control to thf tilftypta Thii it •tptclillM ufiful If tfou writt 

prociBdures Mhich do nojt stop by thMMlvtt. 

Notet The "ctl^'key is like' 
a Shi ft key. In order to 
type ctl-G. hold dOHn the 
"ctr key and type G. In 
this Manual m soMetiaes 
use '* to indicate "^control." 
Thus U stands for control G. 

SoMe primitives have abbreviations. If you type the abbreviation at 
part of a procedure line. LOGO uill expand It to the full form. 

f 
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3. DEFINING AND EDITING LOGO PIUCEOURES 
3.1 TO «nd EDIT (abbrtviattd ED)' . 

\ 8oth coMRindf put you inl^ tditing modi. Thtlr inputs art 
r«tt,ricttd at folloMtr 

I) Ho LOGO prtMitivtt 

i n For EOIT-'ont iiipui» tht mm pf a proctdutt 
uhlch It alrtadu dtfJntd 
^J^fJ^or TO*-*-variablt nuabtr of inputti all but 
tht first art duaayo^ariabltt Hhich ttand 
* for tvtntual'' inputtwto tht-Mu proctckrtf 

tht firtt Input Mu bt any naMMiMich It . V 

not alrtadu tht naat of a proctdurt* ' 
For iort on lnputt» ttt^tlon btloM. 



3.2 END 



Taktt uou out of tditing aodt. 



. 3.3 RESTRICTIONS IN EDITING nOOE 

Uhilt vKki art dtflnlng/tdltlno a proctdurt you can ttlll do Mott 
of tht things you utuajly can do In tht LOGO uorldt utt a dltplay* a 
turtit, a iRusic bOK, or othtr dsvicti tvaluatt proctdurtl-^Hivtn tht tmt uou 
are In tht midst of dtf Ining/tditing. Houtvtri uou cannot dtfint/tdit ang 
othtr proctdurt? That Is^ TO and EDIT art invalid coanands onct you art In 
tditing aodt. 



3.4 THE EDIT BUFFER 

Lin«i uou tgpt paiiv into th« proc«dur«-d«finition via an td it 
bufftr. A lin« ij^put into tht tdit bufftr if th« firflt uord on th« lin« 
it a lint nunbaV (a uholt nuabtr graitar that 0 and lau than 32768). If a 
Itna number ia not praaant, uhat you typa in Mill ba ragardad aa atandard 
LOGO input, uith tha abova rattrictiona. Evary charactar and apaca you 
type aftar a lina numbar ia put into tha buf far until you typa a carriaga 
return. (A aachina-axacutad carriaga raturn>-Hhich happana autowatical fy 
if you typa too aany chlractara on ona lina for tha conaola» or uhatavar, 
to accoMModate— doean't hava thia affact). Tha auccaading carriaga raturn 
Mill than eapty that buf far into tha procadura dafinition. 

a 

Uarn'mg: Tha buf far can only accoMModata 190 charactara and apacaa. a 
little over three linaa on the. teletypat putting in Mora than that 
Mill jaa thinga up and leave you no recouriM but /G. 

Three other Maya to get thinga into tha adit buffer ai*a EDIT LINE, ^ 
EDIT TITLE and '^Y. EDIT LINE (abbreviated EDL). a aingia commd daapita 
the space, takes one input, a line nuaber, and if that lina axiata it ia 
put in the buffer. EDIT TITLE (abbreviated EOT) takee no inputs, and puta 
the title of the procedure you are defining into the buffer. '^V puta tha 
previous line you typed Into tha buffer (handy if you forgot to type a lint 
mmbtr,'^ for aKaapie). 

Uhen you have aomathing in tha adit buffer, you can Manipulate it 
with these special control charactarsi 

1 

prints out and storea the next dwractar in the buffer 
^ prints out and atores tha mxt Mord 
. skips--i.a., delates tha next Hord 
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% » 

prints out and.storts th« t%%\\ and at any^tlM (not just ii>^ 
tditing mode) you can ust, bsiidss ths rubout or dalitt kag Hhich dalatas 
th« previous characttr* 

'^l which dtttttt ^hi prtviout MOrd# ? \ 

/ • ■ ■ ■ ' " ■ • • \ 

3.5 ERASING 

(Hian you ara not in aditing Moda, ERASE (abbrayiatad ER) takas ona 
input, a procedure naaa* and raaovas that procadura fro« uour uorkspaca. 
Uhan uou are in aditing moda, it does the saaa, but uou are not allouaci to 

! ■ ■ 

ERASE the procedure you «re def ining/«ditirig. In edittn]; node onlut you 
can use the cowaand ERAS& LINE (abbraviatad ERL). Ha input la a Una 
mmber, and it erases that ^na« 

3.6 PRINTING OUT * 

Uhen you are not in aditing Moda, PRINTOUT (abbraviatad PO) takaa aa ' 
input any procedure naaa, and prints out the definition of that procadura,v 
By default, if it is given no input it prints out the definition of tha 
last procedure you defined or edited* Mhen you ire in editing mode, it 
work* the eamei ite default input ie the procedure you ire 
def ining/edi ting* 

In editing mode oniy, the coaaands PRINTOUT LINE (abbreviated POL) and 
PRINTOUT TITLE (abbreviated POT) can be used} the first takes 6na input, a 
tine nuwbcr, and prints out that linei the second takes no inputs, and 
prints out the title of the procedure being editeda Neither coMand putt 
anything in the edit buffer* * 



< 
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3.7 OUmv VARIABLES FOR INPUTS 

After iti flrit lofMJt, TO cin tak« further Inputs of the forn t<Mord>it^ 
Each of these ttande for en Input uhich the defined procedure Mill heve ta 
be giveh. See eKeeplee throughout the mnuel. 

' " < ' / . ' 

3.8 PrftJCEOURES UHICH EDIT PROCEDURES 

It is posslbt* to UM anu of tht coMnandt ditcuiMd ibov* uHhin a 
. LOGO procedure. They Hork the sanet with • tingle eKceptiont if the user, 
uorking at top level, tgpes END to finish defining 4 procedure. LOPO 
replies FOO DEFINED (Mhere FOO is the title). This is ngt printed out Hh«i. 
the editing procedures are called by other procedurest a great convenience. 
Note, houever, that the restrkitions of Section 3.3 aluays apply— i^ 
^ cannot be def ining^More then one procedure at a tlM; (See Section 18a2 

4 for aore detai le)e \ 

3.3 comhents 

TsKt enclosed betHScn eKclaaation points or tietueen an aKclaaation 
point and the end of the line is ignored and can be used for coaaente.' 
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4. U0RO3 AND LISTS OF UOR05 

4.1 WORDS 

* 

In LOGO strings of ch«r«ct*rs art caf lad Mordt. A uord may be 

indicatad by prafixing it uith a quota, as int ^ 

?PRINT "UHOOPIE 
WHOOPIE - 

Tht Hord consists of all tha charactart batuaan tha quota and tba 
"follouing space. (A carriaga raturn also tarminatas Hords.V Tharafora a 
uord May not contain a spaca as ona of Its charactart. 

The PRINT coMtnand (aUiraviatad PR) can ba uatd to print uorda aa 
indicated above. PRINT takes one input and prints it follouad by a 
carriaga return. A very siailar coaaind ia TYPE, Hhich acta Just iika 
PRINT sKcept that it dots not include the carriage raturn. A uord may 
Include any printing character OKcapt apace, carriaga raturn and 4 aft and 

right square brackets [ and 1. Jin particular, a uord nay contain quotation 

• I 

Marks: 

?PRINT "A* 
A" ^ 

?PRINT / 



A uord May alio contain no charactart. Such a uord ia called "tha 
tMpty ISord" and is indicated by a quota follouad by no charactarti 

?PRINT " 



A percent sign in a uord is prlnte* as a apace. Thja it uteful in drauing * ^ 
patterna on tht ttlttgpt. as * . 
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TO BOX • 
18 PRINT "XXXXX 
20 PRINT ?XXX1» 
38 PRINT "mW 

48 PRINT mm 

58 PRINT "XXXXX 

END 

?BOX 

XXXXX 

X X, 

X X 

X X 

XXXXX 



4.2 LISTS OF UOROS , ^ 

Ordered col lectlone of Morde Jrt cal ltd Mete . (LOGO ileo tl loMt 
more general^ liete ae deecrilMd in Chapter 15.) A Mat Mau ba indicated by 
giving the worde in tht I let, aeparatad by aptcat md tncloaad in aquart . 



brackate. 



TPRINT n AH A LISTl 
I ATI A LIST 



Notice that the^wrda In the Mat art not quoted and that tha 

eurrounding Wackete are not printed. Tha apacee batpaen tha Morde earva 

only to separate the Morde and, strictly apaaklnfl^ are not part of tha 

list. Extra spaces are Ignored by LOGOi * , • 

?PfllNT lEXTRA SPACESl 
EXTRA SPACES 

A carriage return uithin a liat ie aquivalfnt to a s|»»caj 

?PRINT DIOflE TfHAN 

ONE • 

LINEl . * • ' 

nORE THAN ONE LINE . * 

Going along with the eaptg Hord ua havf the atpty I lat Hhich con- 
taint no motcIsj ^ 
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. NotiB that the ewpty It a uord tnd th« Mpttf list it a lUt md they 

are nat the sawis. , (S*e al»o Stction 4;5.l ' • 

4.3 mNIJ^ATING UqftDS^/li^J LIS^^^ - ' 

There are a number bi operations for naniixiiating uordt and iieta: 

COUNT ■•; . • . ■ ■ . 

>' N Take8,;tine input. If the inp^ria a Mord it obtputa tha nuaber of 

V letters in the Hord. If the Input I* al itt it outputa tha nuabar of Morda 

' ■ -■ . ; ■ ■ > - - ' ■ ■>- , - 

l;n the liet. .~ 

FIRST (abbreviated FJ - ' * . , ' . , 

. Takes one input, tf the input ia a Nord it outputa the f irat 
letter of thi Mord, If the input is a liat It qutputi tha f iret Mord of 

the list. ^ * M • ^ - 

LAST (L) , - • 

■. " : ' ' . ■, ■ ' ■ \ ■ ■ . 

Siai lar to FIRST. Outputs ths last tatter (resp. word) oir a Hord 



(rasp, list) 



1- 



BUTFIRST (BF) \ 

Outputs all but the firsi lattsr of a iwrdi all but ths firit Hord 
of a list,' 

» BUTLAST (BL) V ' ' 

[ ■ Siailar. to BUTFIRST. FIRST, LAST. BUTFIRST, and BUTLAST aay nit ba 
applied to the eaptg Mortf or the sapttf Mat. - ' ' 

These operations take Hords and Mats apart. For putting thaa 
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tog«!ther ue have; 
• WORD " 



Takes itva inputs, both of whfeh Miit bt uord* and put* thM 

togethtr to wake a longw MordJ * ^ 

7PRINT HORO "NOU "ipE 
NOUHERE 

SENTENCE (abbreviated SE) < . , ^ v 

Takes two inputs*^ If both are lisle It puts then together to Make 

a longer list-. If one ie a Mord and one Is a list It adds the Hoi;d to the 

liet. If both are word* It makes a list out of then: 

SENTENCE ITHIS ISl W LIST! outputs ITHIS IS A LISTJ ) 
• SENTENCE "HANGO "CHUTNEV outputs OWNGO CHUTNEYl 
SENTENCE iriATH ISl "YECCH outputs niATH IS YECCHl 

■ ExaMple: , ■ ' - - • / 

TO REPLACE jLET iU jL2 
10 IF »LET - tLl OUTPUT iL2 ELSE OUTPUt tLET 

ENQ. . 

TO LiSP tM 

10 IF jU - • OUTPUT " 

20 OUTPUT UORO REPLACE FIRST lU *S "TH LISP BUTFIRST lU 

. END / 

TO hULTILISP iS 
^ 10 IF jS - I 1 OUTPUT I J 

20 OUTPUT SENTENCE LISP FIRST tS MULTILISP BUTFIRST iS 

END ' 

?PR1NT HULTILISP ItHIS IS A RECURSIVE PflOCESSl 
THITH ITH A RECURTHIVE PflOCETHTH 



4.4 REQUEST ANO TVPEINj nULTlPLE INPUTS 

. The LOGO operation REQUEST wait* for the user to type In a lift and 
then dutputs that list. 

t I . . ■ 
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TO AGREE 

18 PRINT ITYPE SOMETHING YOU UKEJ 
28 PRINT (SENTENCE [1 LIKE! REQUEST [TOO] J 
, : END < ^ - ' 

7AGREE . - • > 

TVPE SOnETHING YOU LIKE 
>PICKLE JELLO UITH PEANUT BUTTER 
I LIKE PICKLE JELLO UITH PEANUT BUTTER TOO 

liri the abova axaiRpIt tht proMpt ch«ract*r > indicattt that LOGO is 
waiting for a REQUEST to b« typtd in. Tht list typtd into a REQUEST it not 
enclosed in braclcete, and ts terminatad by a carria9a«-rajturn. 

The above eKample aleo 4lluttratet that the SENTENCE operation cari 
be Made to take more thad tuo inputs by enclosing the uord SENTENCE and all 
the inputs in parentheses. SENTENCE then coabinoe al l the tnpute Jnto one 
list. UORD, PRINT and TYPE qan also take^aultlpie inputs, in this May* 

■ --.^^^ . \:' 

Note: Do not confuse paf ehtheies and 7^ " 

se^uare br^kets. Parentheses Indicate 
grouping of inputs. Square brackets 
are more (ike quotation marks. *They 
indicate, tfiat something is to be taken 
literaMu'as a Ust. 

REQUEST always outpute a list, even if it is a list containing ont' 

(or no) uords. The operation TYPEIN ia I ike REQUEST except that it outputs 

a Mord. TYPEIN is equivalent to FIRST of REQUEST. . V ' 



^Is.pAtNT 

Under the LOGO print in]| conventions the yupiu Mord and the empty 
. Met both print as a blank tine. Likeuise a uord and a one^iiord list print 
the same: V ^ 

7PRINT "fim£ y 

nunoLE 

?PRINT inunBLEi 
HUnBLE , . 
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Hhilc thif it c(yw«nitni for writing convtrMtional progrMa it can 
also b« Mi^l fading, aspflcialiy uhtn tracking- down bUg« Mhich nay com froM 
confusing Hordt and littt. To halp hara, LOGO provldaa tha coaaand FPRINT 
("Full PRINT") Mhich ia juit iika PRINT axcapt that Jt printa th« bracHata 
aurrounding liati, 

• " TFpiSm cniBLEi . * 

tnUTBLEl 
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S. NUnOERS AND ARITHMETIC 

5.1 INTEGERS 

r 

The largtst int«g«r thai .it accapttd by LOGO arithMtic )• 
2« If?, 483, 647. The tMl last nuMMr ii -2,147,483.647. (Note, hoiMver. 

that nuiibers are HTltten in LOGO Mlthout cqiiiiMt.) 

5.2 INFIX FORtIS ^ , « ~^ 

Each of the. baste arithBatIc opapatlona has an InflK forai ( inflK 
because the auabol goes between the operands)! A 

+ for addition 1+2 

- for lubtraction, 1-2 ^ 
* for nultiplication, 1*2 

/ for^^ quotifit of inttgar division, 3/4 outputs i 

\ for the rsMtaindsr of Inttgsr division^ 3\4 outputs 3 

f ■ - 

- for unary Minus. (This is not technically an inf Ik operator, but 
ita use is effectively the laae as subtracting the operand froM zero.) 

5.3 PRECEDENCE ^ ^ ' 

*,/,and \ have a higher precedence than + and -i that Means that 

»,/, and \ are evaluated before + and -t 

7PRINT 4*5-4*5 

is equivalent to 
7PRINT (4*5)-(4«5) 
20 - (4*51 
20-20 

' ■ 

As oppossd to ^ 
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7PRINT 4«(5>4)«5 
4* 1' «5 
4*5 

28 



Al I th«ie ]n/\n cptrator* h«vt htghar prwtdtnct th«n prtf ix on«a Hhich it 
Mhy all ther arithMtic gttt lion* before any PRINTing h«PP«nt. - 

5.4 NUMERICAL CONDITIONALS 

< . > . and > art infix foras of ()f>trations that compart tuo 
nuNib«rta < Mtant '^Ittt'*. < outputs TRUE H itm first nunbtr is Isss than 
ths second, FALSE othsfuiss* « Mans '*tqutr. > 9s«ns "grsattn". 

That* Mork in the taat Mannar at < i 

?PRINT 180 - in 
.TRUE 

?PRINT 188 > 188 
. FALSE 

< . > , and • havt loHtr firtctdtnct than tha othtr arlthMttllc 
operationt, so Hhtn ptrforaing a coapariton tha arithMtrc It dona firat* 
Thata oparationt art utually utad Hith tha LOGO condltionali. IF and TEST 
(fta Chaattr 9) . 

land > rtquirt that thair inputt ba nuMbart. \ 

-APPLE > "PEAR \ \ 

) \ 

is considsred nonstnss and hHI gsnsrats an srror. ^ \ 
m , hoiiavsr* can bs usad to coapara any tuo LOGO objacts. For aKaapla»' \ 

i 

"FOOEY • "FOOEY 
doat aakt tantt and Mill uork. 
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' ^ 5.S PREFIX FORTIS 

Each of th« arithiNitic opwatiorra hti a praffN fora (frafiK bacauaa 

' •<?■■ ■ ' 

it coaaa bgfora the optraodi)} 

sun + 

_ • DIFFERENCE - ». 

PflOOUCT « • 

QUOTIENT / , • 

\ REMAINDER \ . » 

O^EATER > 

LESS < ' - 

EQUAL - ssr \ ■ 

k 

- u ■ , . , . % 

Sm and PRODUCT aaka uaa of'tha variabia miabar of inputa faatura 
(■»a Saction 4.4). 

m 

?PRINT ISUn 96) . 

?PRI»iT (SU1 1 2 3 4 5 6 7 » " 

\ '28 » », • 



5.6 RANDOM 

Takas no inputt, outputa a aingia digit randowr intagar. 

5.7 FLOATING POINT NUMBERS 

In addition to tha intagar nuaaric fora alraadg mantionad, LOCO 
alao accaptt floating point nuabara. Thaaa nuabara can ba aitpraaaad in tHo 
diffarant foraati for both input and output. Thaaa foraa ara atandard 
cteciMal notation «nd txpontnttal notationa EKponantiat notation it of itm 
folloMing fomi / 

<nuiiibtr><E or N><aKponint> 
Hhara <nuMbar> (cat lad tha aantiaaa) it aithar a floating point nuabar in 
atandard daciaai fora or an intagar, and <a)(ponant> ia an intagar 
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(rtprtttnting a poutr of IB). If thi txpootnt It potitiv«r th« latttr E It 
used to Mparatif tha nuabfr froa its aicpooantt if tha axponant it nagativa, 
tha lattar N it utad» Thara thould ba no tpacat batMtan thata thraa 
alaaantt of axponantial notation. For daciMi notationf a nuabar it' 
HTittan in alwott tha taaa fora at an intagar, but thara autt ba a daciMl 
point at toaa potitiori In tha nuabar. If thit daciMl point it not 
pratant* the nuabar Mill ba ragardad at an intagar. Hara ara toaa axaaplaa 
of vilid floating point nuabart ih axponantial form 
3E4 5N2 , 

3*4E4 4.5^ W 

-4E4 -4N5 

-2»5925e9r -253.259N2 ^ 

Tha foiioMing ara not in corracf axponantial forai 

^ 3E5.1 ) % (Thalixponant it not an intagar) 
2.7E-1 (Tha lattar thould ba N) 

10 El (Thara thould ba no tpaca) 

Tht follouing rfuMbwi art .xMipIti of flcwting point nuM3|irt in 
dtpiMil notationj ^ « 

4. 

4.B6 . 
259.259 

.e008eeee2sg 

Th« output of • floating point lUMbtr uill alHayt bt in oha of 

thtti tMO fornatt. Usually tha output Mill Im in daciMl notation Hith 

non**aignif leant and trailing zaroa raaovad. If tha nuabar ia too iarga or 

too taall to ba rapratantad uithJ digita and a ijNK:iiMil point, it utll ba 

autoaatical ly convartad to axponantial notation (uith ona digit of tha 

aantiata to tha iaft of tha daciaal point)* Tha aaxiaua aagnituda of a 

floating point nuabar in LOGO it approxiaataly la7il4E38t Tha ainiaua 

aagnituda it approxiaataly 2a9387N39 (houavar* thi a cannot ba anttrad fro«i 
* 
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a conwii— th« tMllttt M«gnftud» that can bt jj|iv«n-a« Input \p LOGO it 
i.N38}. Thcst iiMitt art tht same for both potitiva and nagatlva nwrtiwa. 

. All arithMtic optrationt on floating point nuMblri uitid floating 
point nuabar-i. In ordtr to^ forca convaraion of a floating point noabar to 

e. 

an^tagtr. tht INTEGER optration la utad. IHTECER takta ona input, a • 
noating point nuabtr in tttclaal or txpont^tlal fom, and oiitputa thia 
numbtr convtrttd to an intagtr. (RtMabtrt.^Mavar. that INTEGER it aubjact 
to tht standard LOGO Haiti on inttgtr alza, and convaraion of floating 
point nuMbtra tncttding this tizt Mill fail.) In ordtr to forca tha * 
convef-tibn of an inttgtr to a floating point nuabtr,* aiaplg aultiplg b« 1.. 

5.8 NUhBERS AS IWflOS « 

NuMbart art contldtrtd to bt LOGO-Mordt (taa Chaptar 4h all uord- 
isan I pu rating op^ationi Hork on nuabtrt, too. 

.I MPRINT FIRST 45678 
4 . 
?PRINT BUTFIRST 45678 
5678 

?PRINT (HOflO 12 34) + (UOflO 56 78! " 
6912 

Inttgors or floating point nuabtrt axcttding thair ratpactlva aiza 
liaitt ara ttill traatad at Hordt but cannot ba utad in arithaatlc. Evin 
though nuabtrt ara Hordt thay do not hava to ba quotad tgpad in. 

5.9 NUHBERP 

Takat ont input. If tha input It a nuabtr in tha atlouabia ranga 
for iti rafptctivt tgpa, NUHBERP output! TRUE. If tha input it a nuabar 
outtidt that ranga, or ian't a nuabtr at all, NUnBERP outputa FALSE. 
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B. ARRAYS 

I Arragi in LOGO art of on*» tHO or thrta dlaaoiloni. Thara ara 

thraa typai of arraya— Intagar, floatlna point, and polntar. ^ 

'^^i' ' ' '''' '' 

G.1 DEEJNEARRAY 

to craata an array, tha coaw«d DEFINEARRAY (abbravlatid DEFAR) 'It 
uMd. Dtpendinfl on thf nuabar of dlaantiona, DEFINEARRAY takaa up to flva 
Inputa: tha naaa of t^ array, tha diaantlona of tha array, and tha array 
'typa (« for Inlaytr. I for floatlnfl point, 2 for polntar),, H tha array 
haa mora than ona diaanaVon, tha cowiand DEFINEARRAY and Ita Inputs miat ba 
anclotad In paranthaaat* 



\ 6.2 ARRAY SIZE and SPACE Aai3CATI0N 
* Tha aaKiaua alza of arrays la dapandant upon tha currant aiKHint of 

array apaca* Array apaca landraally allocatad to allow approxlMtaly 2GW 
aleaantt in polntar arrant. half thia aiwunt In Intagar and floating 
point arraya. Tha total aaount of apaca uaad la approxlaataly aqopi ttf tha 
auM of tha rtfJabar of alaaahta In aach array, with polntar array alaaanta 
only uainy^alf at auch tpaca aa tntayar and floating point. (HoMavar, It 
should ba notad that avary tlna an array la craatad aoaa axtra apaca la 
usad td »«ora tha datcrtptlon of that array, aaklng It aora afflclant 
raoare^f»fl spaca to uaa slngla larga arraya Mhanavar posslbla.) \ 
^jit la posslbia to allocata axtra spaca for arraya by using iha 

SETASlzit coaaand. SEtASIZE takas ona arguaant, tha aaount of apaca to ba 
allocatad. In Hords (avary Hord storas ona polntar array alaaant, avary tMO 
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Mdrtlf ttoTM on« intigw- or floating point arrau ■iMwit). Ttm iMMiMiMi 
input to SETASIZE i« approKi»#ttlu IIIM. which iMkct it pottibi* to SKpand 
•rray spact by a factor of thrat. Ona iaportant nota about 9ETASIZE-- th* 
ua« of thii cotwand involyaa a ra-inittalization of tha aiza of tha uaar'a, 
uorkapace, Mhich Mahi that a naM "MELCOME TO IILOGO* Mataage Hi 1 1 ba 
printed upon cdaplation of 'tha coMoand. Thua, any uaa of SETASIZE ahculd 
ba invol(ad bafora uaing th«^flling ayltaM in ordar to aava tha troubia of 
having to raad filaa again, ate. 

Arraya ara not aavad in tha filing ayafak (aaa Saction 11. 1). Thay 
ara autoMtical ly iraiad whan you typa HELLO or .CqpOBYE to LOCO, and ao 
thay Muit ba ra-craa^ aach tiaa you uaa Houavar, thay can ba 

araaad at any tiaa by uting tha cMnami ERA$E AMlAY (abbraviatad ER ARHAYJ/ 
Thia coMMahd taliai aa input an array mm and ar^a It fro* your iwrltapaca 
(tee Section 10.2). Tha coanantf ERASE ARFIAYS m ARRAYS) takaa.no inputa 
and eratea all arraya fro« your uorkapace. 

6.3 GET and STORE 

Uhen an array ia created, all the elewanta ara eat to zero. In 
order to atsign valuea to apecific eloMnta of tha array, tha STORE coMMmf 
ia uaed. GET ia on operation uaed to reference the value of a apecific 
elenent. STORE takee the aaaa nuaber of inpute aa tha correeponding 
DEFINEARRAY coaaandi ita Inputa in ordar arat Iha array name, the 
coordinatee of the (paired eleaent, and the valu» to ba aaaigned to the 
ele^nt.. GET takea one leei input than the correaponding STOHTcMMiandi 
ita inputa arat the array naaa, and the ceordinataa of tha daaired alawant. 
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Unlike STORE and OEFINEARRAY. GET outputs a vatua. As in OEFINEARRAY, GET 
and STORE and thtir rasptctivt inputs Must ba anctosad in paranthasas if ^ 
the array is of mora titan one diiwnsior). \, 

It is important to raaaabar in using tl>a GET and STORE operations 
that LOGO uses 8-origin indexing, i.e. for ang dimension of length n, the 
elements are numbered 0 to n-1* For example, the fourth element in a 
single dimension array Is given coordinate number 3; the element in the ^ 
fourth rou, third column of a tuo- dimensional array FOQ la addressed "FOO 
3 2 I and 10 -on. 

6.4 PRltiTING OUT ARRAYS 

ASIZE is an oparition uhich takea one input, an array name 
(quoted), and outputa the dimensions of the array. The command PRINTOUT . 
ARRAY (PC ARRAY) takes as input an arra^^naM and p(*inta out its type and 
dimensions. PRINTOUT ARRAYS (PO ARRAYS) tikes no inputs and performs PO 
ARRAY for all arrays curent I y .defined In your Horkapaca. 

Examples of array operalionat 

?(DEFAR "b' z 2 •) 
. ?PR (GET "B 1 I) 

e 

?(STORE *B 1 1 7) 
PR (GET "BID 
7 ^ 
m (GET "B 1 2) 
^ INDEX REFERENCE OUT OF BOUNDS 

?OEFAR -A 2We I 

NOT ENOUGH ARRAY SPACE ' . 

7SETASIZE 
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UaCOME TO 11L0G(K 
TOEFAR "A 2IM • 
?P0 ARRAYS 

A SIZE 2191 TYPE INIBXR 
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/ ' " ■ ""■ , i7.'»«1ING '■ . / 

7.MWKE • . " ' c ■ ' . 

The LOGO cMMMnd it uttd for nMing. MAKE takes tHO inputai 
thi f irst is ^ht mMW iind tht stcond is tht thing biirH) nMsd. 

flAKE "X P , ' . ' ' 

Mill assign the naee X to 27. ,A naee iMtt be • LOGO Mord (tee Section 4.1 

about uorcli). 27 it the value or thtngt and Mv be a nuMber or a uord or a 

i ^ - . ■■■■ ■ » 

list or anything el te. . 

The ute of the egmbol t (pronounced "dote") ae a prefix to a M«*d 

r.etr levee the thing or value' of a uord. 

. ?PRINT tX ^ - . ' 

. . 27 . ^ , . , 

?t1AkE "XYZ .27 . 

(The MWE) . (Th# THIHtJ) 
TPflINT jXYZ • . 

" : . ■ 27 - ■ ' . 

^ THING ii an'explicii LOCO priaitive that doee Hhat t doae, i.e.. it 
extracts the thing from a Hord. ^ 

7PRINT THING "XYZ 
27 

TtlAKE "RABBIT "HARE - 
7PRINT iRABBIT 
HARE 

7PRINT THING :RABBIT 
ui 1 1 generate an error, because the Hord HARE hat no thing. 
Let's give HAfC a value: ° 



N0(4, 



?f1AKE "HARE lA B CI 
7PRINT iHARE 
(A B CJ 



?PRINT THING (RABBIT 
(ABCI 
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The bacKarrou lymbol («•) It «n inf Ik forM of HAKE ' 

?:NAnE «• 27 
?PRINT tREALNMC 

•27 , „■■; ,;. 

?(U0flO "REAL *NAnE) «■ 27 

Mcrka, too. So do«»i^ / ' 

rNun *. 8 ' . 

?tUORO "ARRAY tNUn) «. "flOSE 

?PRINT THING (MQRD *ARRAY iNllll 

ROSE ' ■ * 



I t it alto pottibit to ute tht HAKE cowMnd to givs Miitipls n«Mtt 
to the lane value. Thit It done in the fol toning Mnnert to give tim nMeo 

A and B the valuta, ua aay 4> :vj ' 
. '•A •-"B«valua> " 
. Thle can be done for an arbitrary nurtxir of naoea (lub'ject only to 
'the limitation on the length of one line In LOGO). Iluliiple HAKE can be 
per formed only Mith the inf U fora of tN HAKE cdnaand 

' :, % ; ' ^ 

lit LOCAL And GLOBAL*NW€S 

The inputs to a procedure are local naaee, that ie« the nma ie the 
procecHre's Qun private name. For exaiplet ^ 



s 



" ?T0 INC »A 
. . ■ ■ . >18nAKE »A tA+1 
>20 PRINT :A 

-«»• i. : ■ " ■ . ■ - , ' - >ENO . 
' INC DEFINED 

?f1AKE'-A3 •, 

^ ■ ■ ■ ■ ■ : ' ■ . ■ * ■ . • . . . ' 

?PRINT «A 



27 



LQGOflANUM. 27 



" In the above exeeplt. the oa«ie A in the procedure hee nothing to do 
Hith the name k at the top levil. 

In contratt, naeee which ar* not Jnpute to a procedure are fliobal. 
Compare with the previous Bxaeple. 

?T0 INC ' 
>10 HAKE "A iA+1 
>28 PRINT :A , 
>ENO 

INC DEFINED 
?f1AKE "A 3 
?INC 

•- • 4 ■ ; ■ 

TPfllNT lA 



Both uses of A refer to the saee global variable. 
It is possible to cause a nana to be local to • procedure even If 
It is not an input. Wis is done with the UOCAL coeaand. U3CAL takes one 

input, the name to be declared local. 

■■ ■ ■ , 

Example:^ ^ , • 

TO COUNTSQUARES jX 
IB IF :)( -0 STOP 
. 20 HAKE "XSQ tX « tX 
30 COUNTSQUARES rX-1 
40 PRINT jXSQ 
(7 END 

TCOUNTSQUARES « 

1 

■.1 

I . ' - ■ 

■ . ■■ ^ 

Here XSQ is a local variable. Coapara Hith 

TO COUNTSQUARES tX 
5 LOCAL "XSQ _ 
10 IF tX-0 STOJ» 
20 HAKE "XSQ iX jS jX- 

30 COUNTSQUARES »X-1 * ' 
40 PRINT iXSQ . 
END • 
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?COUNTSQUMCS 4 

I . 

.4 . 
9 

IB ^ 

' ' i . ' • ■ . 

H«r« each invocation of countaquarat haa ita omh XSQ. 

Na«W8 iocal to a procadura ara dafinad in that procadura and in all 

aubprocedurea (tintaaa tha aubprocadura haa ita om local vara Km of th« 
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8. CONTROL V , 

8.1 GO . 

Thti coiwiand iiutt bt part of a procadurt. It takai ona input, a 
lina number, in that procadura, and tranafar^ control to that Una. 

8.2 STOP 

Thia also balonga In a procadura. It taralqataa axacutlonr of a 
procedure and returne control to tha calling procadura. ^ 

8.3. TOPLEVEL 

Thia raturna control In a procadura laMadlataltf to tha topJaval. 

8.4 OUTPUT 

Thia coaaand can only ba uaad in a procadurai It raturna control to 
tha calling procadura, and outputa Ita arguaant. By ualng OUTPUT tha uaar 
can daflna procaduraa Mhlch ara oparationa. 
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9. CONDITIONALS AND flELATEO COmMOS 
• 9.1 Conditionals art opwationt Hhich output althw TWJE or FALSE. 
You can nakt your OMn. If you uant. LOGO m thrat claaatt of rMdvMda 

conditlonaitt 

a) NuMtrical condltlonalt, a.g. LESS. (Saa chaptar 8.) But nota 
that EQUAL and - can alto taKa non-nuaaric Inputt. 

b) Logical conditionals. Thaaa taka inputa uhich avaluata 

ei thar to TRUE or to FALSE, and parfora logical oparationa on ibmt tlwa 
they ara usad in conjunction Hith othar canditienals. Thay arat 

BOTH-- taKas two inputai outputs THU^ If both ovaluata to 
TBUE, ^ outputs FALSE I f ona or both avaluata to FALSE. 

EITHER- takaa two inputsi outputs TRUE 'If ona or both 
avaluata to TRUE, outputs FALSE If both avaluata to ^AL9E. 

NOT- takas ona Inputt output a TRUE If tha Ir^wt avaluatoa 
to FALSE, and vica varsa. i 

c) Pradicatlva conditionals. Thaaa aaa uhathar or not thair 
inputs avaluata to a spacifiad kind of thing. Thay arat 

- WWW- outputs TRUE If tha Input avalMftaa to ■ Mord, 
FALSE otharuisa. 

LISTP— outputa TRUE If tha input avaiuataa to a liat, 
FALSE othwMist. * * 

ElfTYP— outputs TRUE if tha Input avaiuataa aithar to tha 
aapty word. or to tha aapty list, FALSE otharuiaa. 

^ NUBERP-HHitputs TRUE if tha Input avaiuataa to a nuabar. 
FALSE otharuisa. 
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ExaiiptMi 

MAKE "X t 1 IWKE 37 

?PRINT lOCP iX 
FALSE . 

I ■ 

i , 

7PRINT LISTP iX 
TRUE 

I 

TPfllNTUSTPiZ 
FALSE 

mini EnPTYP tx 

TRUE 

7PRINT NUtCERP COUNT tX v 
TRUE 

9.2 Condititmali can b« itwatad, tttat ii, thtir inputs cm b* 

C(XKlitlon«lsi f 
TO ANYDF iA iB iC 
10 OUTPUT EITHER tA EITHER iP iC 
END 

TO STROKE jA tB ^ » . 

10 OUTPUT EITHER BOTH lA NOT iB BOTH tB NOT sA 



STROKEt 



Parenthvset can b* intartad. if daairad. Thag Right claan up 



10 OUTPUT EITHER (BOTH tA NOT tB) (BOTH iB NOT tA) 
ENO 



Thirt «rft fito t nuMbtr of ttandard cownindt uhich trt UMd tn 
conjunction Mtth condittoniitt thoy ill doMnd thft their inputs •Viluato 

to TRUE or FALSE. 

a) IF and ELSE* IF takti ont inputi if tht Input avaluatai to tht Mord' 
TRUE, tha ratt of tha LXIGO lina ia avaluatadt if tha input avaluatat to 
(FALSE, tha raat of tha lina i a tkippad* Howavar* if ELSE appaara in tha 
lina, tliia bahavior ia modifiad in tha obvious nay. 
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TO CHECK tU 

10 IF UOROP lU PRIMT n»0 ELSE PRIMT •NOWMJ 
END 

?CHECK TOO 4 , 

MOflO. ■ < ' 

TCHEOC [THIS LIST! . ^ 

NOUORO 

IFs (or IF~aSE ptlri) can bt stacktd uithin thMMlvtt. 

-V TO BETTEflCHECK iU * 

• II IF NOT ETFTVP tU THEN (IF MGROP iH THEN WINT "HOBO 
asfe PRINT -NOUOnO) ELSE PBINT WTY 
END 

V 

Hwt. THEN is • "noiM Mord* Mhleh *m not In Itttll affact itm 
•valuation of th« LOCa tMprMtien In Hhlch'lt aupMra. but Iwlpa to luko 
tht tuntaK of tht txiiraitlon Mrs "natural". Tha paronthatta art also 
optional, but h«lp to nakt tht OMpraMion Mtlar to raad. ^ 
bITEST, IFTflUE, and IFFAL9E. TEST avaluatoa Its arguMwit (to TRUE or 

Mr 

F^SEI and putt tht rttult In a "tttt box". Until tht ntxt TEST, IFTHUE 
(abbrtviattd IFT) and IFFALSE (aWravlatad IFF! i4M look Into tht box and 
caust conditional txtcution of tht rtat of tht lint In uhich thty appMr. 
Thtrt it ^ dtvict analogout to ELSE uhich allout conditional txtcutionvof 
only a pai;t of tht rttt of tht lint. Sott non-obvlout proptrtltt of tht ' 

..■;.no,EST,-..-,„«*.-«..„U.,n.4sE^ ' 

dtfaultj itcond, tht box it uniqutn- a ntw TEST* although it May havt botn 
txtcuttd conditional iy, changtt tht eonttntt^bf tht bpK abtoluttly. ^ 

Each proctdurt hat itt oun "tttt box", uhich it ttrictly local to 
that proctdurt. TESTt uhich art tadt In a aubproctdurt do not afftct tht 
tttt box of tht call ing proctdurt, knd convtrttiy. 

IFTmJE and IFFALSE can apptar anyuhtrt in a proctdurt. and thty do 
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not have to bt on th« •*» Hn« (indMd a comund iMch at IFTHUE "FOO 
IFFALSE "BAR can ntvar causa BAR to ba avatuatad.) 

au3 TRUE andmse are LOGO wordi . It la perfect !« valid to eay 
TEST "TRUE ^ ^ 

TEST UOflO "TR "UE 
Reaeaber that all norda Hhich arb to be tahen literally »uat be 

quoted on typein (except for nuabers)t 
TEST TRUE 

■■0'' "'• ' ■ ' 

Mill expect you to have a procedure naaed TRUE. Aleo 

) ' TEST ITRUEl 

ie an error. (The input to TEST aust ba a Hord.) 
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II. UONCSPACE 

UNin gou d«fint a proctdure or crMt* a nam by using MMCC. it 
become! a part of' your uorkipact. You can think of your uorke|>ac« a 
Chalkboard or icratchpad containing all tht prooMhrM won art uting. Th« 
LOGO fiia syttM allout you to storo tvtrgthtng that it in your uorkapac* 
and retriava it at toM latar tiaa (aat Chiptar U). Bafora a procadura or 
naM can ba'uMd it autt ifii in your Morktpaca. To gat aoaathing into tha 
uorkspace you mutt aithar typa it in at tha conaola or* raad it in froa a 
LOCO fila. Tifara ara alao coaam d i for aaaaining m¥t gatting rid of ^ 
various parti of tha uorkifMMi. ^ '•^ 

18.1 UHAT'S IN A UORKSPACE? 

^ PRINTOUT (abbraviatad PO) ia a coaaand which printa out varioua 
parts of your Morktpaca. To aaa tha tant of a procadura* typa PRINTOUT 
fol loiiad by tht proctdurt naat. (Tha procadura naaa it not c|uottd«) 

PRINTOUT TITLES (abbraviatad PO TITLES or POTSI printa out tha 
tittei of all procfdurtt in your Horkfpaco. 

PRINTOUT NAtCS (abbreviated PO NMCS) irinti out all the naMa in 
your uorktpace. 

PRINTOUT PROCEDURES (PO PROCEOURES) irinte out the tOKt of al I 
defined proceduret. 

PRINTOUT ALL (PO NLL) printt both naMi and procedure!.. 

(The PRINTOUT LINE and PRINTOUT TITLE c owand i are diecutted undw 

« 

editing. PRINTOUT FILE and PRINTOUT INDEX are diecueaed under f i i ing. The 
PRINTOUT ARRAY and PRINTOUT ARRAYS c om m it are diecueaed under arraye.) 
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Th« operation CONTENTS outpgti • lUt containing tht titles of all 
procBduras in your Horktpaca. Nota tha distinction batuaan CONTENTS and 
PRINTOUT TITLES. Tha foraar is an oparation, whila tha lattar la a 
coMMand. 

A similar distinction axists batuaan tha co<iwiand PRINTOUT and tha 
operation TEKT. TEXT taKas ona input, • procadura naaa (not quoted), and 
outputs tha text of tha procedure as a Mat. The lines of tha procedure " 
appear as sublists. Tha END stataaant ia not included. 



18.2 GETTING RID OF PARTS OF TT€ WORKSPACE 

The basic coaaand is ERASE (abbreviate*! ER). ERASE foHoMed bu a 
procedure nawe (not quoted) re«»ves the procadura fro« tha uorkapacai 
There are alsot * 
ERASE ALL Cttt rid of ill nwit and ill 

proctdurwa 

ERASE PROCEOMRES Gats rid of the procedures— leaves the 
niMia ^ 

ERASE NAHES Gets rid of the naaas— leavaa the 
procedures. 

ERASE NAttE^ Takes one input, a naaa (qu^^d). and 
gats rid of that particular name. 
(ERASE LINE is discussed under editing. ERASE FILE and ERASE I NOEK 
are discussed under filing. ERASE TRACE and ERASE STEP are discussed under 
debugging. ERASE ARRAY and ERASE ARRAYS are dt acussed under arrays. ) - 
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18.3 BURY 

Th« BURY cotMMnd cfftctivvty "hidtt" a proctdurt and prottctt It 
froM accidental delation. BURY takaa on* infHit. tha tmm of the procadura 
to b« buried (the coaaand BURY Ml can aleo be uaad). Onca a procadura haa 
b«e" bwied, it uill not appear in any PRINTOUT coM«and unlets it ia na«ad 
explicitly. For exaaple.a file FOO uhich haa been been buried ultl not 
appear under the coaaande POTS and PO Ml, but tha coaaand PO "FOO will 
print out the contents of FOO. Thia property alao holda for ERASE 
coaaands. ERASE ALL uill not eraee buried proceduree, but if tha naaa of a 
buried procedure is specified in an ME ceaaand it Mill be araaad. To 
unbury a procedure, tha coaaand ERASE BURY folloHad by tha procadura nwsa 
(or ALL) ia used. ' - 
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, ' 11. nc FILE SYSTBl 

The LOGO flit tyftM atioM you to (on ditk) Mh«t ii in «our 
MorkspacB and reid it back at a iatar tiM. A uttr mv have mang filtt at 
once. The files are distinguished by thi fact that thag ara nawd. Ail 
f i les belonging to a single user are grouped under that user's index . 

U.l USE. READ, and WRITE 

The coimand USE specifies the index under Hhich LOGO should 
reference files. All subsequent HEAD or WRITE coaaands uitl refer to that 
index, until the next USE. USE takes one input, the quoted naae of an 
index, which is a uord of up to ten characters. For exaMple, to reference 
the files under the index ELOISE, tgpe 
USE -aOISE 

The WRITE cottaand creates files. It takes one input, the nana of 
the file to be created (a Hord of up to ten characters). Into the file 
goes everything that is currently In the user's uorkspace. 

This is a coiMon source of confJslon. Many users often think that 
if they have, for exaeple, a procedure naaedi BEETLE, then 
WRITE "BEETLE . 

Hi 1 1 soeehoM save only that one procedure. This' is not the case. Al I the 
procedures in the workspace will be saved. The file will Merely have the 
eaMe naae as one o* the procedures in It. 

If the user already has a file with the saiM nawe as the one to be 
created, LOGO will first ask if the old one should be erased and then wait 
for a response (Y or N) to be typed in. The old file Must be erased before ' 
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a new file with the saMe nane can bt created. 

The READ coMteand takes a file nmm at input and reads the content* 
of the ff le into the Morksp»ce. AM procedures and na«es saved in the file 

Hill then become defined in the Mrkspace. If the uorkspace already 
contains a procedure Mith the saute natM as one of the procedures in the 
file, the procedure Hi 1 1 not be redefined and the definition in the file 
Mi I i be skipped. 

SNAPS (see Section 13.3) cannot be saved in files. If PIC, for 
eKample, is the nane of a snap, then writing out the uorkspace and reading 
it back uiil cause :PIC to becow* the empty Hord. 

11.2 POI and POP r 

These are coMMands Hhich ailou you to exanlna files Mithout reading 
them into the uorkspace. 

PRINTOUT INDEX (abbreviated POD takes no inputs and prints the 
names of all the files in the* index. (The index is specified by the • 
previous USE comwand.) PRINTOUT FILE (PO FILE) takes a file name as input 
and tgpes the contents of the file. It.does not read the file into the 
workspace, i.e., procedures in the file Mill not becoMe defined in the 
workspace. , 

ERASE FILE^ (ER FILE) takes a file nmm as input and gets rid of the 

f i le. 

11.3 FILE SUBTLETIES 

The description of the filing systeM so far, though accurate and 
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adequate for opdinaru'ute, it incoeplttt. In fact, the |0D0 file tutte* 
hat a tree structure. The coeeandi USE, READi URITE, ttc.» «• described eo 
far, make use of that ttructure only inpllcitly. But they can fee iwde to 
use the filing tree much more explicitly, end there are other cowwande not 
yet diaicu98/d which allQM a user to Jianipulate the tree — pruning it, 
adding branches, etc. 

Each user's index can be the root of a general tree structure of 

i « •. .. . - 

files. This means that the index eay not only contain files, but also sub- 
indices which contain fi tee and tub-indices and to on. For exaeple, the 
index ELOISE might contain the filet OAYl,'nARBLE» and the tub- Index 
OISaAY which containt flltf dealing HithElolte'i diaplay projecte. In 
this case, the .file structure MOMid bei ^ 

I aoi5E 

DAYl 

* harble . ' 

i display. ... . 

WALK * 
DRAM 

" POLY . 

etc. ' • 

The I's specify indices. (Normally a nustoer will appear after each 
file name.® This it jutt the number of ttorage blockt that the file 
occupies.)' This tree structure it printed out by the PO TREE command. 
(Note that the tree ie actually uptide down, with the root at the top. ^ For 
this reason, the root of a tree, it often referred to at the "top level" of 
the file system, while the branches are called the. "lower levelt", where 
m;»(h Fiih •n.(^y rtfir^ntnU $ new level.) POI doet not print out the 
tuHteMt^ ut WiiMictf. In^'tht 4tiov« c«it« it ndulcl print: 
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ELOISE 
DAVl 

I DISPLAY 



« 



(The root index does rwt have an I 

Each file in this tret structure rt ipectfied by a hit etarting 
with. the user naMe. This* list gives the "pa(li" doMn the tree frow the user 
na** to the fl le. For exayle/ to read the file OIMU In Elotse*e sub-index 

DISPLAY He could say: ' ^ 

USE "ELOISE ^ V ■ 

READ IDISPUY DRAW 

or ue could sa<^, . * 

USE (ELOISE OISPUYl 

In general, the input to the REto coiiand li ftbed onto the 
of the prevloue USE> cdMiand and the Mhola ttr jng baconet the f I le 
specification. (What happens is that the USE eoasiiand establishes the level 
from which all follouing conwiands are to be carried out. Thus, if the USE 
command ^efer8 onlyL to th« user naM, tha'path to a file contained under a 
sub-Index Hill be longer than if the USE conmand refers to the the deslrtd 
sub-index.' I4e -Hi 1 1 sse later hou this level can be changed ulthout 
repeating the USE»coeeand.) The inputs *o MRI IE, fOF, and ERASE FILE all ° 
work in the same nag. Uhile POI prints out the Indei specified by the 
previous USE cowand, PO TREE prints out a aore co«iplete version, 
consisting of all of the tree contained be lou thJe index, including sub- 
indices. , , > 

To cf^eate a iub-index, the CRINDEX cotmand is used. This adds on 
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to the branch specif ied by the previout USE. For txa«ple, Q^OISE'S sub- 
index OtSPLAY Mas created by tgpinlgi 

use •a.oise « 

CRINOeX "DISPLAY 

To then create a sub-indeK of DISPLAY named PLOTTER, wt could 
$iiiipty say: * ^ 

•■ ■ • , . 

CRINOEX IDISPLAY PLOTTER! 

To get^rid of an index use' the ERASE INDEX coiMiand* This iaiket on« 
input uhfch specif ieSi in the eaiie Manner at the above coMands, the index 
to be erased. An index nay not be erased unleee it i,f eiiptUi i<ee, 
contains no flies or sub^indrcest , 

Once an index has bnnn created, it is possible to adjust the root 
of the file tree so that ail filing coMiands refer only to those fllei arKi 
indices contained in the tree beiou a specified index* The cofuMand uhich 
d^es this i^ SETINDEKe SETINDEX (abbreviated SETI) takes one input 
specifying an index Mhich ulfl be the root of a neu tree forning son^ part 
of the Mho I e file tree of the uorkspace* As before, the input specifies, 
the path taken down or up .the tree froi the current root to reach the 

desired index, H wore than one level of indices is involved in the path, 

\. ■ ■ 

a list is lrtece$sdry to specify the Mholi path. Houever, if the desired 
ir>dex is just one level above or belou the current root, i tingle uord is 
sufficient to'specify the path. ^ 

Once an index belou the user name has been est.abliihed as the 
current root, all cowMands refer only to that part of ttm *tree belou thia 
nevi index.- For example, let* s cons^ider Eldise*e file systen again, only 
this time uith a feu more Ranches addeds 
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aoisE ' 

I DISPLAY 
UAU 
ORAU • 

POLY • 
I WGEm 
FACTOR 

I miHix 

INVERSE 

Irt order to make ALGE8RA the nen root index, the coMMnd SETI -ALGEBRA !• 

used. The new tree (printed out by PQ TREE! look* like thiet 

ALGEBRA 

FACTOR * 
I MATRIX 
INVERSE 

Notice also that file* not in this part of the tree cannot be read 
Mithout going back up- the -branch- and down another until the appropriate 
index under MhicH the file i. contained ia raach«i. For eKa.,ple; tgping 
READ -POLY ui 1 1 return an error aeeeaga* -FlU NOT FOUND", i^nce the path 
na«e has not been fully ipecified. 

\xx' order to Move the current root back up the tree touards the Min 
directory naae, the input -M. used. The up-arro« can be used in liate 
just like index naees. so that a list containing n **s used ae input to 
SETI moves the current root Up n levels. Thus, the above eKaaple. in 
or<ter to read POLY, the coiNiand READ r POLYJ la used. 

11.4 OPEN FILE MANIPULATION 

.OPENM takes one inp^^ desired file naae (quoted). (This file 
ctoes not have to already exist in the file syetea.) .OPENU opens the ^ 
•elected file (or creates one If it does not already exist) antf^alioiia It 
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to be urit ten into, starting at the beginning of the fiie. If the file 
already exists in the filing systM, the uMr will be atked to dtitte it 
before ur i ting, since the old inforMtion contained in the file uiM be 
written over by the neu input to the conMod .FILEP; 

' .FILEP is used, once the file hat been opened for uritlng. to 
perfore the actual writing. .FILER takes it Input a Htt containing the* 
desired information to be written into the file. Each- time eFILEP is used, 
a new line (with a MKiwue length of 190 charactered is created in the 
file. The input to .FlLEP can also be a procedure name (unquoted), in 
which case the procedure is executed and its output is written into the 
file. If there is no output, nothing is written. 

.OPENA opens a file for writing eueh like .OPENU, but all ^ 
inforeation written is added (appended) to the end of the file. None of 
the original contents of the file are altered. .FILEP works in the ssm - 
Manner as before. 

.OPENR is used to open a file for reading. It takes one^ Input, the 
desired file naes (quoted). The coeeand used with .OPENR to do the actual 
reading is .FILER. Unlike .FILEP, .FILER takes no inputs but returns an 
output. This output Is the current lint of the file being read. Every 
time a file is opened for reading, an internal pointer is set to the first 
line of the file. Each tiM .FIL£R ii ueed, this pointer it incremented to 
that the next line Hill be read uith the next uie of .FILER. Uhen the end 
of the file is encountered, one blank line ulM be printed out by .FILER, 
and then the file Hill be autoeatically cioaMl. In order to read the file 
again, .OPENR muit be used again. If the currant line of the file ia a 
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procedura na«t, that proctdurt Mill bs •Mcuttd. (This fact •nabitt • uttr 
to execute proctduret " i MP licit ty" Hhile reading a file. It it utilized 
by the INIT file; tec the LOGIN coaMnd.) Any uord encountered uhich ie 
not part of a procedure definition or ia not a LOGO coaaand it attuaed to 



be a procedure Mae/ if such a procedure doea not exiat, an error uill be 



If no file it currently open; the coaaand it ignored. 

U.5 LOGIN 

LOGIN taket one input, your uaer naae (quoted). Thit "telle the 



eystea who you af-e", and thit inforaation ft uaed by the PEEIC coaaand. 
LOGIN also ilerforat an autoaatic USE. Houevar, LOGIN it aott uaeful for 
initializing certain conditiont in the Morkapace and for printing out Mail. • 

Uhen LOGIN it uted. the tyttea lookt in the uter'e file tyttea to 
«ee if there is a f i Ie naaed INIT iti the top level of the file tree. If 
this file exists, the tyttea readt the file and perforat all coaaandt 
uritten directly into the file (through the ute of the coaaandt .OPENU, 
.QPENA, and .FILEP). Thit facility allout the user to do aany uceful 
thingt. For inttance, the INIT file can be uted to read all the filet in 



the uter't file tystea "autoaatlcal ly" uhen logging in, or to print out 
aeatages upon logging in. 

The LOGIN coaaand alto cautet the ayttea to search for the file 
naaed HAIL. If this file it found, the contantf «r« printed, and the user 




returned. 



.aOSEF ia used to close any open file. .(105EF taket no inputs 

y' ■ ■ ♦ 

and clotet the fi Ie currently open (only one file at a tiae can be open). 
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is then asked if the nail thould be dbleted. 

U.B PAPER TAPE 

LOGO procedures nay also be stored on paper tape. The user May 
pass information between paper tape and the Horkspace using the following 
primitives. 

URITEPTP punches out the contents of the workspace onto paper tapa. 
It does not involve the file system. 

REA^TR reads into the workspace from the paper tape reader. 
Neither READPTR nor HRITEPTH take any inputs. 

You should have someone show you the mechanics of using the reader 
and punch before you use the paper tape commands. 

c 
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12. TURTLES 

This ttction i« about tt» phytiMl turtlti that run around on tha 
flooi-.' (Saa Chaptar 13 for diapiay turtlaa.) 

12.1 You Must fall tha syataa Nhich turtia you want to uaa bafora iatuing 

turtle coiimands. ) ^ ' . , 

TURTLE 

Taket ona input i*lch should ba tha nuabar of tha turtia you uant 
to uaa. Tha nuabara ara aarkad abova tha plugt on tha control lar box, and 
»ra 1. 2, 3 or NotmHu only 1 and 2 hava turtlaa piuggad into tha«. 

NOTURTLE 

Takes no inputs. NOTURTLE rjlaasaa tha turtia frow your control so 
soMaone else can use it. ■ 

12.2 BASIC TdPfTLE COtflANOS ^ 

FORUARO CFD) 
BACIC (BK) 

These coaaands take ona input which aust ba a nuabar batuaan -327M 
and 327G7 inclusive. They coaaand tha turtia to aova <lnput> unite foruard 
(in the direction it ia pointing) or backMard. 

RIGHT (RT) 
LEFT (LT) 

These take one input nhich auit ba a nuabar batMeen -32768 and 
32767 inclusive^ They coaaand iKa turfle to rotate <lnput> degrees 
clockMise or countsrclockHise, respectively. 



I 
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PENUP (PW- 

PENOOUN (POJ ^ 

Raises or Iomti th« p«n holdinO MtchantM of the turtle. Uhen the 
^ is doMn the turtle uilt drati « line at it Movet. 

12.3 SOME TURTLES HAVE A HEADLIGHT 

'^AOPON 
LAflPOFF 

Tiirns the headlight on end off. 

•I 4 • 

12.4 some have a uhistle „ 
' toot 

Takes one input which nutt be a nwfcer between -32768 and 327B7 
inclusive. It bloHi the whistle that noaber of tines. ' , 

12,B TOUCH TURTLES " 

There is a varietu of turtles that have sensors that cao'teli when 
' the turtle is bumping against an object. The following priaitlves are used 

to test whether sensors are on or off. » 

FTOUCH . ^ 

Outputs TRUE if the front of the turtle is touching sowthingj 

FALSE otherwise. 

BTOUCH Means back touch ^ 
RTOUCH aeaf^ji right touch y 
LTOUCH means left touch 
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Hwe** a. proctdurt to'bounc* iht turtit bctHMn tuo Mlltt 

TO BOUNCE 

10 TEST FTOUCH 

20 IFTflUE UEFT IM ! TURN MOUND 
30 FORUARO II 

40 BOUNCE ■ 
ENa , 

If the turtit it hitting an objtct at an olilHua angi* tHo touch 
itntort May bt TRUE at tht taM tiat* 

12.G SEEING EYE TURTLE 

Ut havt a t)rototypt turtlt-Mith-an-tyt. Tht aya ia axtrtiiwly 
tiMpit - it ttllt tht Mount of tight it it taaing in a vary niarroM fiald. 

LIGHT 

Outputt tht light Itvtl^ Thii it a nuabtr batMttn • and 63. 

LAnPON 
LATIPOFF , 

Seeing eye turtlat don't havt htadlightt (ytt). Thtta conMiandt 
currently enable and dittblt a aodt uhtrtby tht tyt can rotate. LATIPON 
enables this mode, LAif>QFF ditabltt it. 

FORUARO, BACK, RIGHT. LEFT 

Uhtn in tht Modt dttcribtd above thaaa coaaandt change the angle of 
elevation of the aye. Uhtn not in that node thaaa cowwinJi parforM thair 
noma I functiont. 

12.7 THE LIGHT BOX 

V It it convtnitnt to utt tht light bOK in conjunction Mith the 

ttaing-tyt turtit. Tht light boK can aupply currant to any tubttt of up to 
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six light bulbs (at ths mmnX only four light bulbs art pluggtd in). Ths 
light box is control Isd bg wmding }t a nunbtr via ths .TVO co»»and (••• 
Chapter-lS). The light box is spwifisd by tht input "LIGHT , so to ssnd 



the number 20 to the box tgps 

.TYQ "LIGHT 28 « , 

Uhat the box does Hhen It gats a nuabsr U dttaraintd as folloMs; 

Urite the number in binary. Than the 

Ts place specifies Hhcthar light number 1 is to ba on 

or off, the 2*9 place light number 2, the 4's placa 

I Ight nuHber 3, "etc. 

Note: The controller to Hhlch the light box 
is attached traps 17 (octal 21) as its reset 
character. Thus 17 sent to the light box 
uill not be seen. If you deiperately Hant 
to send 17 (to turn on lights five and one 
together) you can use tha fact that the light 
box ignores more ihan six bits and send It 
64-I-17-81 (octal 131). 



12.8 THE SWITCH PANEL 

The switch panel Is a "blue box" which has on Its front 1$ small 
light bulbs. "Each of these lights represents tha status of one of 1$ 
hardware switches. Uhen a witch Is set, the corresponding light is turned 
on; when it is cleared, the light Is turned off. The following LOGO 
primitives can be uied to test and manipulate tha status of these suitchas. 

SWITCH 

* Takes orte argument, tha number of a switch (S-15) and outputs TRUE 

If the switch is set, otherwise FALSE. 
RELAY 

Takes two inputs, tha miabar of a switch and a value to be assigned 



no 
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to it (0 or 1). If 0. tht tuitch it tirnMI off, if 1, it iH turrwd on. 

BITOUT 

Taktt ont input, a fMMb«r uhich it convtrttd into • 16-cliglt binary 
value. Each digit of this valut it than uaad to datar»{na tha condition of 
th« corrasponding twitch (aff*ctivaly tha taM aa parforaing a RELAY for 
aach tuitch). 
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13. DISPUY TURTLES ^. 
The display acrMn i« 460 turtit units high by 400 uide. Th« 
center of the screen has coordinates (0,0){ the botton left hand corner is 
(-288.-288): and the top right hand corner is (280.200). Uhen the turtle 
is pointing straight up Its htading it Htading it fNiiturtd clockuitt 
(i.e. RIGHT) free that position. , 

13.1 INITIALIZING THE DISPLAYS 

CLEARSCflEEN (CS) 

Erases everything on the display screen and places the turtle at 
the center of the screen pointing up. You should do CS first, before 
iesuing any other coeeands to the turtle. 

UIPEaEAN (MC) 

Erases everything on the display screen but leaves the turtle 

it is. 

NODmAY 

Tucns off the display. 

STARTOI SPLAY 

Takes one input, which Miet b« • or 1. • etarts up a half-size 

• J 

display. 1 starts a full size display. STARTDISPLAY 1 it «ie sawe as 

CLEARSCREEN. ' T 

/ 

•r . . , 

13.2 BASIC COmANDS 

FORUARO m if " 

BACK (BK) • 
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Takes oo« input Mhieh Mitt bt tithtr an }ntag«> op floating point 
nortjor. riovet tht tortit <input> unltt foruard (In tht dlrtctlon it it 

pointing) or backuard. 
RIGHT (RT) 

LEFT (LT) ' 

Takss ont inpuWuhich Mutt b« tithor an intagar or floating point 
miiiber. Rotates tha turtia <input> nuabar of dagroM clockHisa or 
counterclockufsa, raspactlvaly. 

. , PENOOUN (PD) . 

r ■ . . . 

PENUP (PU) 

Lowers or raises the turtle's Metaphorical pan. If the pan ia dOHn 
the turtle draus a line aa it Movaa. 

« 

PENP 

Outputs TRUE if the pen la doun. FALSE if it Is up. 

WRAP 

NOMRAP t 
WRAP enables a node so that If gou try to Move the turtle beyond 
the edge of the display it uraps around to the other edge. NOURAP turna 
off this mode: if you try to Mova beyond the edge you gat an error. 

HIDETURTLE (HT) 
SHOUTURTLE (ST)' 

HIDETURTLE tells the coMputer to atop shouing the little'triangia 
that represents the display turtle. The turtle hIII still drau linee (If 
the pen is down) even though you cannot aae hia. SHOUTURTLE bringa tht^ 
turtle out of hiding. 

53 
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13.3 sIlAPS 
SNAP 

Takes no inputs* Outputs a rtfsrinca to "tha stuff on tha display 
sdreen.* For OKaaplat 

MAKE "PIC SNAP ^ 

causes :PIC to rafer to Mhatavar is currant ly on ihi scraan« Later you 

" • ' ^- ■ 

can cause another copy to appear by saying t 

DISPLAY jPIC 

pr erase it by flMingt 

UIPE JPIC 

Each SNAP hat aitociattd uith it a "atarting location" uhich it 
normal lu the centtr of th« tcraan (but ««t aiao NEU5NAP). SNAPS cannot b« 
saved Hith the URITE comMnd (wm Saction U.l). 

DISPLAY % 

• V „ 

i Takei one input which Mitt ba a SNAP (l.t. a rafaranc* craatad by 
SNAP). The SNAP is diiplauad at the currant turtle position and the turtle 
is then moved to the end of the SNAP, at if the turtle had jutt draHn the 
SNAP explicitlg. The turtle's heading has no affect on the displaged SNAP. 
The SNAP aluags appears in the orientation in which it uas original Ig 
drawn. 

s 

UIPE ' 

T 

Takes one input which must be a SNAP. It erases all appearances of 

«r 

that SNAP froM the display scraen» « . 

Takes no inputs. It causes the iiage currently on the screen not 

. rr 4 i ^ 
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to be part pf subsequent SNAPS, Aiso sets the start Ino location of 
^subsequent SNAPS to the current position of the turtle rather than the 
center of the screen. . . • / 

13\4 locating the turtle ' . ^ ' 

-'"here / . - ■ ... 

SEXmm (SETT) • " 

" ' ^ \ ^ ■ , , ■ ■ • ■ ' , ; ■ ; / ' . .■ 

HERE outputs i ll»t of th» x-coordlnit** y-coordlniti and heading., 
of the turtle. You can ose HERE td naife a place ort the dleplay. SETTURTLE 
takes one input, a 11 et of three nunbere betueen -32768 and 32767 , - 
inclusive. The first it assigned to the x-coordinate. the second to the u- 
coordinate and the third to the headi^. You can use SETTURTLE ^to Bove, the 
turtle to a place that uas naMed using 1€RE. -It liHl draw a line If the 
pen is doMn. 
: . HOnE 

- / XCOR * 
YCOR ■ ° - 

■ . ■ - . ■ . .'^ -' ■ ■ " 

HOriE is equivalent to SETI 10 0 0J. XCOR outputs a nuMber which is 

the current x-coordin^tf of the turtle, YCOR outputs a nu*er Hhicb is the 

current y-coordinate' of the turtle. 0 . 

"... SETX „ ■ V , ■ ■ ■ •." 
. SETY 

■ -^seyxy'; 

SETX takes one nuaer teal input and Moves the turtle horizontal ty to 
that X-coordinate. SETY takes ^one rtueerlcal input and Moves the turtle 



LOGO riANUAL S5 



vertically to that Y-coordinate,- SETXY takt» ttw nuwerlcal inputs and 
moves' the turtle to the ,desi|gnated position* Each of these cowiands Mill 
drau a line if the pen is down. 

HEADING ' 

SETHEADING • 

HEADING outputs a number uhich it the heading (in degrees) of the 
turtle, i.e^t .the direction in which it is pointing^ SETHEADING takes one 
number as >.fnput and points the turtle in that directione 

». ■ " ■ ' * 

13,5 PLOTTER V 

The plotter is often used in conjunction uith displays. To use the 
plotter, type PLOTTER. Hhen you are through^^ing the plot ter» type 
NOPLOTTER* A1I other plotter coMands are !the same as display coiHiandSs 
HoMever» certalin^display coeeands do not apply to the plotter and Mill be 
ignored"! f typed to the plotter, ThsM art all fairly rtJviouSt they 
includes CLEARSCREEN. UIPEaEAN,, WRAP. HIDETURTLE. SHOMTURTLE, SNAP, WIPE, 
and DISPLAY. The plotter also has a eorf restricted argument range than 
^he displays, . ^ 

13;6 flULTiaE DEVICE CONTROL " ' ^ > 

It is possible to control wore than one devict at at time on LOGO. 
Tliis can be done through the use of the conwiandt ALSO aind CNTRL. If you 
are already using one device and uiah to use\jpnoth«r Mithout [giving up the 
first, type • 

ALSO <devics> 
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Mhere <d8Vfce> 19 tha dtvice you uiih. to um. ALSO givta you access to 
additional devices, but It Is necessary to specify to which device a 
specific coiiiiand is directed. This is done with the CNTHL cpaiMand. CNTRL' 
takes one Input, the naee of a device which you currently "oun". and 
specifies that device as the object of the. next ooMMnd you type. For 
exainple. suppose you are using a display and you decide you want tb use a 
floor turtle also. First type . 

ALSO TURTLE <nuiiiber> 
However^Jf you noH >type ♦ 

TOOT ' * 
LOGO Mill respond 

TOOT ONLY VALID IF VOJ HAVE A TURTLE 
Before you can direct coMMnds to the turtle, it is necessary to 

type 

4° ' ' - 

^ CNTRL TURTLE <nu(«ber>. 

All valid floor turtle coimands u| i I now be accepted. If you want to use 
the display again, you must say 
CNTRL OISPLAY 

LOGO noM Mill accept display coaeands. but not /\oor turtle 
commands. Each t lie you want to change between devices, the CNTRL coaiMand 
•referring to the device that^you want to use wist be typed. However, 
subsequent comands can only refer to one device at a time. 
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tUSIC BOX , 
LOGO has prinitivo uhich supply output for the Mtic box. A LOCO 
user can specify parts for up to 4 simuttaneous voices* each voice having a 
range of five chromatic octaves* In-order to avoid tieihg problems the 
music is compiled into temporary storage and then output 'to the. box at a 
constant rate, rather than played in Veal time'^. 

14.1 NOTE 

The NOTE fioMiiand g«ner«ittt one nott of mutic. NOtI takes tuo 
numerior inputs, the first specifies the pitch and the second the duration/ 
Pitches are numbered chromatically from ^Zh to 36 uith 0 being middle C. 
There are also three special "pitches"! 

-28 is a si lence 

-27, -2G are the percussion sounds "boom" and "ssh" 

-25 is net a valid pitch 

Durations must be betueen 0 and 127 units. Each unit is normally 
about 1/8 second (but iee NVOICES beloM), 

The actual output of NOTE tP :D is determined as follous: 

If :D « e NOTE generates nothing* 

If :0 « 1 NOTE generates a pitch 1 unit long 

If ;0 > 1 NOTE generates a pitch tO-1 units long foiloued by I unit 
of rest. Therefore, music Mill not sound "slurred"* 

If sP is -26 or -27 NOTE generates a sound for one unit folloMed by 
tO-l units of rest* This makes ^it convenient to use the percussion sounds 
to "generate a beat". 

58 



NOTE can alto taka Multipla inputs . Tha forMt it (NOTE :P1 tDl 
:P2 :D2 etc;) Mhere lach pair tpacifiat tha pitch and duration for ona 
note; (The total nuabar of Inputi auitiS^ avan.) . 

: ^■ 

14.2 FTl • 

The coaaand Ptl (standi for PLAY HUSIC) takat no inputs. It causes 
the output of previous NOTEx^aaands to be piayad on tha Music box. As tha 
Music is played it is erased froM teaporary storage and aust be regenerated 
if you Mish to hear it again. Typing a ctl-G Mhile Muaic is being played 
causes an iMMediate break and also clears out teaporary storage. HaEAR 
can be used to clear out the Music buffer. (Teaporary atoraga is allocated 
'in the saMe area as the user's procedures, variables, ate. The aaount of 
Muaic that May be coMpiled at one tiMe depends therefore on hoM Much other 
stuff is in the user Morkspacs.) 



14.3 VOICE 

The music systea can generate up to four siaultaneous voices. The 

VOICE command directs, the output of subsequent NOTE coMMands to the various 
voices. Pn then plays the voices siMultaneously. 

Example: ' 

TO SEVENTH iTONIC jD 

le vOICE 1 NOTE jTONIC iD 

2r VOICE 2 NOTE :T0NIC+3 tO 

30 VOICE 3 NOTE iTONIC+€ tO 

40 VOICE NOTE iTONIC+3 iD 

50 Ptl 

END 

Mill ptay a chord* * 
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VOICE takes one inpat which nuit bt MJn^mbwr betMten 1 and 4, Tbii 
becoMBS the currant voi CI until tb« ntKt voica coawiand it given.*. If no 
VOICE coimand is given, the •gittn outpute to voice nu«ber 1. 

■ )■ 

14.4 VLEN and rHEN . 

These are operations Mhich take no Inpute. VLEN outputs the total 
length of the Music compiled for the current voice. tlEN outputs the 
length for the largest voice. 

For instance, if ue have generated a nelodg in voice nueber 1 ue 

can provide it uith an accoMpaniment: 

TO OOMPAH • , 

18 VOICE 2 

20 (NOTE e 4 (-5) 4) 

39 IF VLEN - HEN STOP aSE GO 20 

END ' 

This uill generate oompahe for at long ae the melodu laete. 

14.5 NVOICES • 

The music system normally mutttplexes output among four voices. 

Voices for which no output his been generated are fed silences. It is also 

possible to send output to only one or t mo voices. This is done Mlth th« 

NVOICES command; * 

NVOICES 1 output only to voice 1 

NVOICES 2 output to voices 1 and 2 

NVOICES 4 output to all four voices (the normal, mode) 

Since the music box is fed at a constant ra(e NjfOICES 1 (rasp. 

NVOICES 2) causes the basic unit of duration to be one-teurth (rufp. half) 

' c» * 
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as long as with NVOICES 4. NVOICES also citars out taaporaru storage and 
resets the current voice to voice 1. 

14.6 Nonusic 

Only one user at a tine mag have access to the Music box, Uhen a 
user gives a Music'coeeand, LOCO assigns the Misic Dok to hiM if no one 
else if usmg it. A user Mag release the Music systeM bg giving the 
NOhUSIC coMMand. 

14.7 nUTYO AND nUCTRL 

These coMMands are a contlbution toward rNl-tiMe Music generation. 
They enable the user to bgpass.the Muusic buffer, and the Pfl coMand. and 
hence have a chance at least to generate real-tiMe Music. 

nUTYO takes 2 inputs, each one a Music box pitch, and Makes the 
music box play the pitches. Pitches to nUTVD are the saMe nuMbers as 
pitches in the regular Music syste* — Middle C is t. rest is -28, and so 
" forth. nUTYO autoMaticat ly converts those pitch nuMbers into the nuMbere 
the Music box hardware requires. 

hUCTRL stands for Music control. Its Main purpose is to specify to 

the MUSIC box hardware how Many voices you uish to load . This is siMilar. 

to the NVOICES coMMand in the regular Music «ysteM. 
\ 

/ 

14.8 SYSTEM CONSTRAINTS 

The Music systsM has been designed Hith specific uses In Mind. 
(See, e.g, the papers of Jeanne Baeberger.) Users Mho are haMpered by thit 
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should bear in mind that tht tTYQ cowMid can bt uatd to output arbitrary 
characters to the Riutic box. (Set Chapter 19,) 
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^ • . IS. LISTS 

LOGO it tquipptd to tumdit gmal i'ittt. i.t. Ilttt uhoM tlMNnU 
May thenselves b0 lUtt. For txaaplot 

• ■ - 

ItTHIS ISJ A tLIST .STfWCTUfiElI 

is a list of three eleMents. tuo of Nhich art liatt. 

reiNT does not print tha outer brackata around a Hat. 

?PRINT iriHIS ISI A ILIST STBUCTUBEJJ 
ITHIS ISI A ILIST SmJClUREJ 

AH of the Mat oparationa deacribad In Saction ♦ Mork uith ganaral 
liata, e.g.: 

HAKE *A I ITHIS IS] A ILIST STBUCTUHEIJ 

COUNT :A output 3 

FIRST iA outputa ITHIS IS) 

BUTFIRST :A outputa IA ILIST STRUCTURE!] 

LAST I A outputa ILIST STRUCTURE] 

BUTLAST tA outputa ((THIS IS] Al 

SENTENCE general fzaa ae follouat 

If all of ita inputa are liata. It puta thair alamanta together to 
Make one big liat: 

(SENTENCE (PIECES OF] (A BIG) ILISTll ^ 
outputi [PIECES OF A BIG LIST] 

If any of the argoMenta to SENTENCE are uorda It firat convarta 
each Mord to a one-Hord Mat and appliaa the above rulai 

(SENTENCE "PIECES lOF] "A "BIG ILISTl) 
outputi (PIECES OF A BIG LIST) 

LOGO hat ioMe other Mat operations. LIST takee two li^te and 
outputa a 2-eleMent Hatt 

IlIST (THIS IS) (A LIST] 

outputa ((THIS IS) (A LIST!) ^ 

LIST can alao take Multiple inputa. it outputa a liat whoa* 

G3 
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eltmentt are the inputtJ ' » ' . 

(LIST ILOTSr "OF ILISTSJI 
outputs tdOTSl OF (LISTS! 1 

Notice that if all inputf to LIST art Morda, than LIST ia aqulvalant to 

SENTENCE. . * . 

FPUT is anothar «ist*optration. It takas tMO Inputa of Mhich th« 
second must be a list. It sticks tha flrat Input onto tht front of th« 
second to make a neu list: 

FPUT "THIS [IS HOU FPUT UORKSl 
outputs [THIS IS HOM FPUT MORKSl 

FPUT [THIS ISJ IHOU FPUT MORKSJ 
outputs [[THIS ISl HOU FPUT> UORKSl 

LPUT is siailar. It sticks its first input onto tha and of tha 

liat. 

LPUT -THIS IIS HOU LPUT UORKSl 
outputs [IS HOU LPUT UORKS THISl 

LPUT [THIS ISl [HOU LPUT UORKSl 
outputs IHOU LPUT UORKS [THIS ISll. 

FPUT and LPUT can also take Multiple Inputa. Tha last input Muat 

alMays be a listi 

(FPUT "HAKE [TMISI [A LISTl) 
outputs (riAKE [THIS! A LIST] 

^^ (LPUT "HAKE [THIS! [A LIST!) 
outputs IA LIST HAKE ITHISll 

Lists may also contain SNAPS as alaawnts. e.g.i 

HAKE "A SENTENCE "UOU SNAP 
than it is perfectly valid to sayt 
PRINT FIRST lA 

or 

DISPLAY LAST lA 



PRINT ih 
Mi 1 1 'givt an •rror. 
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IG. DEBUGGING FEATURES 
LOGO includ«t features wWch aid uiere in cWJugging their pro- 
gra«8. The simplest euch feature ie ctl-G. Pressing ctl-G will stop 
execution of any progra.. If}t is not mKh help is a drtxigging feature, 
it^t least can serve as a panic button* 

16.1 PAUSE, CONTINUE AND ctl-Z 

Uhen the PAUSE coiwand it executed in a procedure, the procedure it 
temporarily halted and control is returned.to the console. Instead of 
typing only ? as a pro-^t ch«.act«-. LOGO also indicates at uhat l.v.i it 
currently is. .Level refers to "hoM ««n« proceduris deep" current enecution 
i.. (Co«.ands given fro* the console are at level 1. Co«»and. given in 
procedures called fro., the console are at level I. Cosni^o^s giv«T in 
procedures called by' level I procedures are at level 2. And so on.) Mhila 
in a PAUSE the user can access any naaes which are local ,t|^^ procfdur.. 
For example; 

TO BLA ;A a 
18 FORWARD »A 
28 PAUSE 
END 

A is a local naae. Running BLA hUI cause LOGO to pause. Ue can 
then access the value of A, ^ 



''BLA 28 

PAUSE AT LEVEL 1 IN LINE 28 IN BLA 
^ L1?PRINT :A 

28 
LI? 

There are m to get out of a pause. Typing ctl-G wi 1 1 . at 
usual, return the User to the top level. 
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The CONTINUE coaMMnd (abbrtviattd CO) uHJ continut tKccutlng th« 
procedure starting with the nent line after the PAUSE. (Mote that for this 
reason PAUSE should be the last coMMnd on a line if the user uishes to 

continue.) 

Uhile it is legal to give any LOGO coMiand in a PAUSEd situation, 

the user nay get into trouble If he or she erasts or adits ^the procedure 

- ) 

and then tries to continue. 

. ■ * 

Ctl-Z is siwilar to ctl-G except that it generates a pause rather 

than a break at the top level. 

IB.Z DEBUG . * 

The DEBUG coMeand changes Mhat LOGO does Hhen an error is 
encountered in a user's prograa. Noraallu. an srror prints a Mssage and 
terMinates execution. ,The DEBUG facility causes errors {o generate PAUSEa. 
The user can then exaaihe local variables and CONTINUE uith tha next I in* 

IF 

Of the procedure. DEBUG is a coamand Hhich takes no inputs. ,Its usa 
sMitches this feature on and off. 

16.3 TRACE- 

' The 'TRACE coMiand' takes one input, uhich is the name of a 
procedure. Thi procedure na«a is not quoted. Every tiae a TRACEd 

procedure is run* LOGO prints out a Message to that effect and tells uhat 

■ ' r ' ' 

the inputs to the procedure a^e. LOGO also indicates if the procsdura 
outputs. ■ ^ ^ ^ 

To get rid of a TRACE, usa ERASE TRACE «s im 
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?ERASE TRACE <procBdori naM> 

It is possibit toitract all' proctdurti by laying TRACE ALL. Thar* 
is also ERASE TRACE ALL. 

\ 

ie.4 STEP 

STEP IS like.a "suptr TRACE\ Not only ii tN procedure TfTACEd but 
before each line of the procedure it executedt LOGO typti out the line end 
waits for the user to responds There are three options! 

(1) Typing a carriao^ return causes the line to be executed 
and goes on to the next line« 

(2) Typing ctl*G terninates execution as ajnaysa 

(3) Typing ctl-Z generates a PAUSE at described 

above. The user My then execute other coiMiands and later 
CONTINUEa ^ 

The syntax for STEP Is like TRACE* ERASE STEP, STEP Ml. and ERASE 

STEP ALL are also availlblea 
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. : - 17. ERROR HANDLING " ^ 

The error handHng facHiiiM allou you to nodify tht uay LOGO 
treats errors, • ' 



17.1 ERSET and ERCLR -J . ' 

The ERSET coitiand takes on* i nput, « procedure naaw. As w I tfi TO, 
EDIT, TRACE, etc. , the procedure nanie I s not quoted. ERSET causes the 
procedure gi ven as ii^ut "to be executed every tlie an errw* occurs. The 
procedure Hi I I afib be run eviwy time ctl-G or ctl-Z is hit; -After the 
procedure has been executed, LOGp takes the folloMlng acttoni 

(1) I f the procedure does not output. LOGO print*. the nprial error ' 
Message. . 

(2) ff the procedire outputs, LOGO prints the output instead of the 

normal error Message. 

I f an error occurs In the ERSET proc»dure itself the ERSET ui 1 1 not 
happen. The various SYSTEM BUG errors cannot be overridden by an ERSET, 
The ERCIR commarfd, Hhich takes no inputs, deactivates ERSET. ; 



17.2 ERRET. and ERLIN 

As described above, m ERSET can provide persoml .g^^ nieesagttt ^ 

■ ^ " . ^ ■ ■ ' /■ • . 

but eiill terminates execution. Another use of ERSET it to allou the 

■ > .. ' * 

possibility of Modifying the condition that caused the error and continuing' 
execution. The command 01RET takes one input, a line number, and - returns- . 
eKecutipn to that line of the procedure ih which the error occurred. ^ 
Useful in conjunction .with this is the ERLIN operation' uhicti outputs the 
lihe;nuMber in which the error occurred* Thutt for tKaiiipU^^ 
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ERRETv€RLIN , 

in an ERSET ppocedure HHI rii-execute th« line.in Mhich tKe erroi* occurredi 

Examples ^ 
. . Here is a W to iwvB a ball^ back and forth acoM th« screen. 

Supoa^ :BALL is a SNAP of a ball and ue move the ball by: \ 

TO nOVEBALL 
10 FORWARD 28 

20 DISPLAY {BALL ^ - • 

30 UAIT B 
40 WIPE :BALL 
50 GO 10 

. . "END. ■ • .': ■ ' ■ 

Run nOVEBALL but firat ERSET the folloMing procedura: 
TO TURN 

10 LEFT 180 , 
20 ERRET 10 

END ■ . 

Now every 1 1 ae^ the "OUT OF BOUNDS" error occurs TURN hIM turn the 
turtle around and keep going. 

But this simple scheme hat a bad bug. TURN hIM be run Mhenever • 
any error occurs. Even uorse* It will be run when Ma hit ctl-G, Ther.e it 
no way to stop nOVEBALLI What we really want It to only axecute the ERRET 
in th? case of the particular error "OUT OF BOUNDS". 

17^ ERNAtt; ERBRK, and ERPRO 

To help overcope the above-Jiientioned bug, LOGO providat the ERNAM 
, operation. The easiest May to find out the name of an error, i» to 
generate the *rror and then PRINT ERNATI. Ua can fix the bug In TURN above: 
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TO TURN 

18 TEST ERNM1 • "OQB 
28 IFFALSE STOP 
38 LEFT 188 . . 
WEfWET 18 

■ -.■■END ■■ ■ ♦ • * ■ ■ ■ .■ 

("OUT OF BOUNpS"'h»f itror n«w OOB) 

ERPRO outputs the. rMMM of ^tht proctidurc in uhich tha l«tt arror 

occurred, so if m« uould Mkt TURN to only tik* if fact during HOVEBAU. liw 

cth TEST to see if ERPRO - "lUVEBALL. 

E-R8RK handles ctl-G and ctl-Z. It it an operation Mhich outputat 

1 i f the "error*, uas caused by pressing ctl^ 

-1 if the "error" uas caused by pressing ctl-Z ° 

S.otherHtse. , 

SoMetiaes it is useful to set things up to that preeslng ctl-G 

during a REQUEST re-does the REQUEST rather than stopping tha prograM. 

Here is an exaiitiile of hou that cen be donei 

TO SPECIALREQUEST 
18 ERSET TRYAGAIN 
28 riAKE "X REQUEST 
38 ERaR 
48 OUTPUT »X 
END 

TO TRYAGAIN 

18 IF ER8RK - 1 ERRET ERLIN 
END 

. ■ ' • ■ 

UitKTRYAGAIN ue can still stop the shou by hitting ctl-Z. 

17.4 ERNUn, ERTOK, ERLOC, md ILINE " 

ERNUn Each tUP« of error has a nuaber as ual 1 a| a naaa. ERNUft 
outputs the nuaber of the error. 
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^ ^ERTOK outputs th« "t'ok«n numbtr" at Mhich th« prtvlout •rror 
occurred in the line. This gives soM indication of exactlu Hhere in the 
lint the error occurred, but it is hard to use unless you arc initiated 
into the Mysteries of the LOGO evaluator. 

EFILOC outputs tN location in the POPll's core at which the error 
occurred. It is useful eainly to systee prograMNrs. ^ 

ILINE outputs the last line typed in at the console. It is useful 
for doing analysis of errors that occurred while the ueer was typing In 
"direct conwiands". 
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18. EVAUMTINC TEXT 

18.1 RUN 

It it often uMful to ovaluato cow m iii ttitt hovo boon ceoputod 

rather than tgpod in, Tho baoic LOGO prioitivo Nhich deot thit it njN. 

RIM takoe ono input, a list, and ovaluatoa tt jMOt ao if tho liot Moro 

tuped in at tho contolot 

?RUN [PRINT •UOMl 
UOU 

If tho input to RUN tpocifioo an oporation. than RUN dutputot 

7PRINT RUN tSUn 18 51 
23 

Of couroo, tho input to RUN nood not bo typod In litoraliiK 

VtPRINT RUN (SE "SUH 18 S) 

- 23 • , 

For oKaople: ' , ^ / 

?t1AKE "X "PRINT 
?RUN SE jX S • 

' 5 ■ 

Another example: 

If MO have procadurei calfod, say. STRATEGYl, STRATEGY2, and 
STRATEGY3, one uay to invoke tho proper ono it to eayi 

RUN (SE UORO "5TRATE6V tN) 
if :M ia 1, 2, or 3. (Jo use SE uith one arguoont tinea RUN*t input Mutt tit 
a list. > 

. there ie a tricky point hort.^ RUN OMocutot tho titt iutt at if tho 
I tst Mere tuped in . In the exaipio 

RUN g>RINT "HOU] ! . 

tho firtt character in the tocond Mord of tho input U a quota. To 
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gentrate the Hat Mt Mould tuy - 

RUN SE "PRINT ""MOM 
In contrast th« coawiand 



flUN SE "PRINT "MOM 



it equivalent to 



RUN tPRINT MOM) 



Mhich Hould be an erfor unlcae thtra Mart • proctdurt nawtd MOM. 

t ' 

18.2 PROCEDURES DEFINING PROCEDURES 

It It valid in LOGO to have" a proctdura Mhidv daflnat anothw- 

procedure! 



TO DRIB 
le TO DRAB 

28 18 PRINT "MHOQPIE 

38 END 

END 



Running DRIB daflnat the procadurai 

TO DRAB 

18 PRINT "MHOOPIE 
END 

Naturally. Mt can utt RUN In thlt contantt 

TO DEFINE »PflOC »N 
18 RUN SE. "TO iPflOC 
28RUN SE III PRINT! tN 
38 END V 
END 



r 



uill caute 



DEFINE "MHM10 7 



to create 



TO MHAtIO 
18 PRINT 7 
END 
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In a tiMilar Mnntr, proctdurM My wi\i proctdurtt. ^ 
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19. niSCELLANEOUS CCWWfS 

19.1 \ 

BELL takti no inputs. RIngt th« b«ll on th« conwit. 

CLXK takBt no Inputs. Output* • nui*tr Mhich }• lncr«i«nt«d •v»r« 

1/B8 seconds. 

DATE outputs a 3-tl*iitnt list containing »onth, day, 

TIHE outputs a 3-at^t list containinfl hour, winutt, Mcond. 

UAIT takts on* Input. 1:ausas LOGO to Halt foj^Jhti iii*nvi 1^8 

stcpnd intsrvals. 

HELLO citars out Horkspactj •rtstarts" LOGO for you. 

GOODBYE saw* as HELLO. 

LEVEL takts no Input*. Output* a nui*«* which tails "hon «aoy 
proc*(lures deep" currant oxscut Ion I*. 

PEEK print* out *y*t*a *tatu* InforMtlon. 

tIAIL Th* tIAIL co«iiiand anabl** u**r* to **nd M**ag** to oth^- uw 
on LOGO. HAIL tak*» on* Input- th* u*«- naiw (quot*d) of th* p«-*on to 
MhoM th* mail i* to b* •*nt. Th* coaputor r*.pond* with a b*ck-arro« (-) 
♦ihich indicat** that anything typad In o^i th* con*ol* I* r*gard*d a* mH. 
To and the aessay*; typ* a Una with a .IngI* parlod foMo«*d by a carrlaga 
raturn. The co«.pl«ttd ««**»g« »• than plac*d In th* filing *y*t*«i of th* 
u**r to who- it •• s*nt, containad in a file na«ad HAIL. Tha Mail can ba 
read aith*r Mhan logging in, or by printing th* fll* u*lng th* PDF co«iMnd. 
It 1* h*lpful to b* logg*d in Hh*n .*ndlng aall, ainca th* u**r's login 
nana is ussd to id*ntify th* sourc* of. th. aall to tha p«^*on who r*c*iv.. 
it. 

► 
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SEND takM tuo inputs. Tht first it tht fnmb9r of • consottt and 
thf sMond It t iitt Mhlcli It prlnttd out at i Mtttot diroctly on that 
contoit. V 

SYSPR ttkit «t input i Iitt uhich it prlnttd out M a atttaot on 
al l contoitt currtntly in utt. 

SIN talctt ont nunbtr (riprtttntlng dtgrttt) at ir«Hit and rtturnt 
tht tint of that angit* 

COS taktt ont input In dtgrttt and outputt tht cotfnt of that 

angit. 

- «* ■ 

It 

IB.2 IMPLEnENTATION OEPENDEHT PRIfllTIVES 

Tht follouing art priittivti Hhich rtftr HMcificallu to thif 
inpteMntation of LOGO. 

.TYO taket two inputs. Tht firtt tptcifitt • dtvict. Thit nay tw 
el ther a devict nuMbtr or ntM. Tht na«tt that LOGO undtratandt for 
dtvictt are: 

"LIGHT for tht light box 

"TURl for turtit 1 

"TUR2 for turtit 2 whtn It If piuggtd In 

"tmSIC for tht Mutic box 

"PLOTTER for tht plotttr 

"TTY for i|Ou OHn contolt. * 

Tht ttcond input tptcifitt a nutbtr Hhlch it rtiaytd to tht givtn dtvict at 
output. \ 

Tht obvioui utt of thit ftaturt It ulth ragard to tht light box. 
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.TYOino to a turtlt it ilightlu uitfuh ctrtain coniMndi that can bt dona 
by the turtle hartkiare have navar baan iMpla«anttd.in^LOGQ aoftuara (Mainly 
because they ar« only very slightly usefuU. The turtlt can, for -instance* 

uaddLe instead of walk* 
Try this program: 

TO UADOLE :STEPS 
10 IF :STEPS - 0 STOP 
20 .TYO "TURl 9« 
30 .TYO "TURl 95 
i 40 IWOOLE -.STEPS - 1 ' • , ^ 

.END 

The interested reader it referred to the TURTLE GENERAL Engineering . 
Handbook, Appendix A. for aora detal la. 

.TYI takee one input which epeciflea a device ^n the aa»e wanner at 
.TYO. The next piece of information (interpreted at a nui»ber) received 
froM the device it given at output. 

.CLOSE If you ute .TYI or ,TYO, LOGO aatigna the device to you ao 
that 00 one else can ute it. To releate the device the .ClOSE cotwand ie 
utfed, taking at iti input the given device tpecification. 

•CTYI and .CTYO are aiwilar to .TYI and .TYO except that the 
tpecified device it the uter'a coneola. .CTYO takat one Input, .CTYI takaa 
none* 

CTYOWAIT and TYOUAIT 

These coaaandt are a apeciat of UAIT coawnd -- like UAIT 60 - but 
inttead of waiting a fixed amount of tiae, they wait until a teletype haa 
finithed typing out. 

. . A simple ute of CTYOUAIT ia to lyiwhronlxe a procedure that draMt 

') . . . ' • 
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on the display and alto prints stuff out. Suppos* you uish to draw a POLY 
and print th« turt la's heading at sach comar. NorMliy in such a prograw 
the displaying gets further and -further ahead of the printing. But, 
CTYOUAIT uill force the procedure to Hait for the printing to lie conpteted 

before gojng on: . 



20 RIGHT lANtlE • 
38 PRINT HEADING 

40 CTYOUAIT 18 !The nuirtMr is hou Mich tiiM to Mait in 
addition to uaiting'for the teletype. 

58 POLY tSIOE tANGLE 

END ' . . 

TYOUAIT is lil(e CTYOUAIT. except that you ipecify which device to 
uait for. TYOUAIT understands the sane device naiMs that .TYO and coMpany 
understand. It also accepts teletype nuabers. A good use for TYOUAIT ie 
to synchronize the floor turtle uith the display turtle. 

.GUN takes one input, a user nueber, and restarts that user'e LOGO' 
(equivalent to typing HELLO at his console). Thi% is used uhen eottieone'e 
consle gets hopelessly hung pp. 

.CASES14 On consotss equipped to handle louer case, LOGO norMll.y 
converts characters to upper case. .CASESU ie a'coeeand uhich takes no 
inputs and turns this feature on and of f. 

.ECHOSU takes no inputs. Turns off and on t feature uhich inhibits 
echoing of characters typed at the console. 



TO POLY iSIOE lANG 
18 FORUARO tSIOE 
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28. HAINLY for SYSTEH PROGRAOnERS 
Th« folloMing prl«ltlvM^d«al Hlth tht Mlnttnanct and drtjugglno of 
the LOGO system. Thty art uttful Hinly to tgttt^ proflraBtffi. 
.STF and .CTF aat and citar a trKt of tha avaluator. 

.SGCF and .CGCF sat and claar a faatura which cauaaa a garbaga 

cqI (action aach tiMa a noda if al locatad. 
.SPNF and .CPNF set and clear printing the nu«ber of free nodaa 

left when garbage CO If act I one are run. 
.STATUS unlock protected coiwande ■> 
.PWRCLR do a reset of the POP H and all davicaa. 

Not to be used casually. 
,f*J6 halt LOGO and start the debugger 
.SETTV set the systen time variables ^ 

. . . ' V- 

.GCOLL run a garbage collection. 

.EXAMINE examine locationJn POPll core. ^ 

.DEPOSIT deposit into core, 

.NODES output number of free 'nodes. 

.VERSION output which version of LOGO this ie. 

.VALtJE output the item on top' of the S-POL. 

.USRTIDE output the amount of user time "run by the ayatam. 
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^ * 2K Mi INDEX OF LOGO PRimTIVES 

Thf p«g«t that foMoM art a lilting of pratwit LOGO priiitivtt. 

Mith tht aKception of tht aiMciat coMMndt iittod in Chaptar 2f. Along 

Mith each priMitivc i« tht foMpuing inforaationt 

ABB.-- Abbraviationt and Infix foraa. Infix forM art indicatad by 

(i). 

NUf«eR OF IHPUTS- Tht Indication nV Mana tht priMitvt My uit tha 
varlabit input ftatura' fSta Sactiori 4.«,i«hara n la tha atandard nwibar of 

inputat* J , - 

OUTPUT-- Y atant It doatootpujW^aaana it doai not. 
PAGE(S)~ tha iM-lMrg pagtla) on uhich tha priaitiva la diacuatad, 
plua any laportant aupplaiantary inforaatlon. 
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